<head>
    <title></title>
    <style>
        <!--
        .paraindent {
            padding-left: 40px;
        }
        .ulindent {
            padding-left: 20px;
        }
        h4{
            padding-left: 40px;
        }
        body {
            font-family: Verdana;
            padding-left: 20px;
            padding-right: 10px;
        }
        -->
    </style>
</head>
<html>
<body>
    <h2>How to Use Directory Synchronizer</h2>
    <p>
        Directory Synchronizer is a simple utility to synchronize the contents of one file directory to another while taking advantage of
        file system information about the directory contents to avoid copying files that already exist and do not need to be
        recopied.&nbsp; Directory Synchronizer does this by checking if a filename in the synchronization source directory already
        exists and if so, whether it has the same file length and timestamp.  If it does not, depending on the synchronization options selected,
        it will copy and overwrite or move and tag the file into the synchronization target directory.  The synchronization is by default recursive, 
        meaning all of the sub-directories and file contents in the source directory will be copied to the target directory.
    </p>

    <h2>The Directory Synchronizer Main Window</h2>
    <p class="paraindent">
        <b>Source</b> This textbox shows the selected directory that will be used as the source of the file operation.&nbsp; 
        The 'Browse' button to the right of the Source textbox can be used to browse for a folder.  The selected folder must be on a local 
        drive or accessible through the local area network.
    </p>
    <p class="paraindent">
        <b>Target</b> This textbox shows the selected directory that will be used as the target for the file operation.&nbsp; 
        The 'Browse' button to the right of the Target textbox can be used to browse for a folder.  The selected folder must be on a local drive
        or accessible through the local area network.
    </p>
    <p class="paraindent">
        <b>Preview Only</b> If selected for a synchronization operation, will prevent any physical file operations from being
        performed, and outputs a list of the files and operations that would be required to make the target directory contents identical to
        the source directory.
    </p>
    <p class="paraindent">
        <b>Rename Instead of Overwrite</b> This option prevents files that exist in the target directory or subdirectory from
        being overwritten by files from the source directory by copying the existing target directory file to a tagged filename.&nbsp; 
        For example, 'C:\targetdir\exists.txt' would become 'C:\targetdir\exists1tg.txt'.&nbsp; 
        Some caution is merited: depending on the 'Tag Filename Instead of Delete' setting, these tagged files can be deleted by subsequent 
        synchronizations.
    </p>
    <p class="paraindent">
        <b>Tag Filename Instead of Delete</b> This option prevents deletion of files that exist in the target directory or 
        subdirectory from but do not exist in the source.&nbsp For now, the files that would be deleted are tagged identically to overwrite
        prevention tagged files.&nbsp; Note, with this setting, in a typical repetitive synchronization scenario 'source orphaned' files, 
        or files that are in the target directory but not in the source directory will grow a file length such as "filename1tg1tg1tg1tg.txt"
        with repeated synchronizations, making them easily noticable in directory file lists and search results.
    </p>
    <p class="paraindent">
        <b>Don't Overwrite or Delete</b> This option is mutually exclusive with the two "tag" related options above, and instructs
        a synchronization operation to ignore all overwrite and delete operations called for during a syncronization.
    </p>

    <h3><b>File Menu</b></h3>
    <h4><b>Advanced Options</b></h4>
    <ul class="ulindent">
        <li><p class="liindent"><b>Do Not Synchronize Sub-directories</b> instructs a synchronization to only copy files in the source directory,
                    not any subdirectories.&nbsp; Target subdirectories are not deleted.</p>
        </li>
        <li><p class="liindent"><b>Suppress Datagrid</b> Hides the synchronization results datagrid for slow computer performance improvement.</p></li>
        <li><p class="liindent"><b>Copy Attributes</b> Copies the file attributes (Archive, Hidden, Compress, etc.) along with the file, otherwise
                    a synchronization created copy will have default attributes associated with new files.</p>
        </li>
        <li><p class="liindent"><b>When Avoiding Overwrite...</b> This complicated option means that when a file would be tagged instead of overwritten, 
                    the file copy from the source directory is copied to the tagged filename, instead of the target directory file being
                    moved to the tagged filename.&nbsp; Note this only applies if TagInsteadOfOverwrite is selected,</p>
        </li>
    </ul>
    <p class="paraindent">
        <b>Save Setup</b>
        Displays a file save dialog for selecting a file to save the current Directory Synchronization options, including source and
                target directories, as well as advanced options.  The resulting file can be loaded by the Load Setup file menu item, as well
                as by passing the saved setup options file to the Directory Synchronizer executable as a command line or explorer shell parameter.
    </p>
    <p class="paraindent">
        <b>Load Setup</b>
        Displays a file selection dialog for selecting a Directory Synchronizer options setup file to load.
    </p>
    <p class="paraindent">
        <b>Exit</b>
        Exits the Directory Synchronizer program.
    </p>

    <h2>Other Nifty Features</h2>
    <ul>
        <li><p class="liindent">Command line and explorer shell arguments can be used to input either a single file path to a '.dso'
        Directory Synchronizer Options file, or to two directories for use as the source and target directories, in that order.
        </p></li>
        <li><p class="liindent">Double-clicking the datagrid of synchronization results will open a file explorer window to the selected
        file directory.
        </p></li>
    </ul>

    <h2>Cautions and Compatibility Considerations</h2>
    <ul>
        <li>
            <p class="liindent">
                Open Source:
                The majority of this source code for this version of Directory Synchronizer is openly available at the codeplex project linked above.&nbsp; 
                If possible, it is better to know what code you are running on the computers you use.
            </p>
        </li>
        <li>
            <p class="liindent">
                File System Directory Name Delineation:
                Directory Synchronizer was primarily written for Microsoft Windows operating systems, which are not
                case sensitive for file names or file folder names, and therefore caution with conversion ports to non-Microsoft
                Windows operating systems is recommended.
            </p>
        </li>
        <li>
            <p class="liindent">
                File System File Name Length Limits:
                As of Directory Synchronizer's initial v1.0 authoring, the default tag added to a file name or 
                directory name instead of deleting or overwriting is three characters long.&nbsp This means
                that caution is recommended when repeatedly synchronizing a source and target directory pair many
                times with any of the 'tag instead-of' options selected as file-system incompatible extremely long
                filenames might possibly result, which would cause a synchronization operation in progress to halt.
            </p>
        </li>
    </ul>
    <h3>That's It!</h3>
    <p class="paraindent">Check the <a href="http://on-space-si.com">On-Space Software Inc.</a> website for updated versions and email info@on-space-si.com with questions or suggestions.</p>
</body>
</html>
